home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / mail / pp / pp-6.0 / README < prev    next >
Encoding:
Text File  |  1991-12-18  |  9.7 KB  |  331 lines
  1.  
  2.  
  3.  
  4. PP-GEN(8)             MAINTENANCE COMMANDS              PP-GEN(8)
  5.  
  6.  
  7.  
  8. NAME
  9.      pp-gen - generating the PP message system
  10.  
  11.      You should read over this entire document first, before typ-
  12.      ing any commands.
  13.  
  14. READ THIS
  15.      This documentation describes how to configure, generate, and
  16.      install  the  PP  message  system.  It is intended only as a
  17.      quick guide. The full details are in  the  PP  documentation
  18.      set  -  _P_P  _M_a_n_u_a_l$  _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _O_p_e_r_a_t_i_o_n. This can be
  19.      found in the doc/manual/volume1 directory
  20.  
  21. SYNOPSIS
  22.      make
  23.  
  24. DESCRIPTION
  25.      This is a description of how one can bring up the PP message
  26.      system.   It  is assumed that you have super-user privileges
  27.      in  order  to   (re-)install   the   software.    Super-user
  28.      privileges  are  not  required to configure or generate this
  29.      software.
  30.  
  31.      PP is normally installed with most programs and  directories
  32.      owned by a single user. Conventionally this username is "pp"
  33.      and is not a normal user id but this is  not  required.  You
  34.      should normally do most of the compilation and configuration
  35.      as this user.
  36.  
  37.      The distribution tape contains the hierarchy for the pp-6.0/
  38.      directory.   Bring  the  sources  on-line  by  changing to a
  39.      directory for local sources and running tar as the pp  user-
  40.      name you have chosen, e.g.:
  41.  
  42.           % cd /usr/src/local/
  43.           % tar xf _t_a_r_f_i_l_e
  44.           % cd pp-6.0/
  45.  
  46. CONFIGURATION
  47.      First, go to the config/ directory:
  48.  
  49.           % cd config
  50.  
  51.      Select the Makefile and include-file  skeletons  which  most
  52.      closely match your system.  The current choices are:
  53.  
  54.           sun     Fairly standard sun configuration
  55.           vax     Fairly standard vax configuration
  56.           s5r4    System Five, release 4
  57.           hpux    Hewlet Packard
  58.  
  59.           _m_o_r_e _s_a_m_p_l_e_s _w_e_l_c_o_m_e
  60.  
  61.  
  62.  
  63. Sun Release 4.1     Last change: 25 Nov 1989                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PP-GEN(8)             MAINTENANCE COMMANDS              PP-GEN(8)
  71.  
  72.  
  73.  
  74.      The makefile skeleton  has  the  extension  .make,  and  the
  75.      include-file skeleton has the extension .h.
  76.  
  77.   MAKEFILE
  78.      Copy the makefile skeleton of your  choice  to  pickle.make,
  79.      where  "pickle"  is  the name of your system.  Now edit this
  80.      file to set the _m_a_k_e variables.  There are  many  of  these,
  81.      please  refer  to _T_h_e _P_P _M_a_n_u_a_l: _V_o_l_u_m_e _1 - _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d
  82.      _O_p_e_r_a_t_i_o_n. However, some of the more obvious  variables  are
  83.      documented in ./OPTIONS.make.
  84.  
  85.      Link pickle.make to Make.defs in the base directory.
  86.  
  87.           % ln pickle.make ../Make.defs
  88.  
  89.  
  90.   INCLUDE-FILE
  91.      Copy the include-file skeleton of your choice  to  pickle.h,
  92.      where  "pickle"  is  the  name  of your system.  Now add any
  93.      additional definitions  you  may  need.   Consult  the  file
  94.      ./OPTIONS.h for a list.
  95.  
  96.      Now, link pickle.h to ../h/config.h.
  97.  
  98.           % ln pickle.h ../h/config.h
  99.  
  100. GENERATION
  101.      It is assumed that you  have  ISODE  7.0  installed  on  the
  102.      machine  in  question,  including the X.500 libraries -ldsap
  103.      -lisode. If you wish to build the  grey  book  channels  for
  104.      JANET  mail,  you  should  first build and install the unix-
  105.      niftp package.
  106.  
  107.      Go to the pp-6.0/ directory and generate the basic system:
  108.  
  109.           % cd ..
  110.           % ./make
  111.  
  112.  
  113.      This will cause a complete generation of the system.  If all
  114.      goes well, proceed with the installation.  If not, complain,
  115.      as there "should be no problems" at this step.   It  may  be
  116.      worth  saving the output of the make stage in a file in case
  117.      things do go wrong.
  118.  
  119. INSTALLATION
  120.      You will need to be the super-user to install the  software.
  121.      There are two kinds of activities: once-only activities that
  122.      you perform the first time the software  is  installed;  and
  123.      each-time   activities  that  you  perform  every  time  the
  124.      software is installed.
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 4.1     Last change: 25 Nov 1989                    2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PP-GEN(8)             MAINTENANCE COMMANDS              PP-GEN(8)
  137.  
  138.  
  139.  
  140.      The first once-only activity  is  to  create  the  necessary
  141.      basic  directories  to install the commands. This is done by
  142.      issuing the command as super-user:
  143.  
  144.           # su
  145.           # ./make dirs
  146.  
  147.      Note that the pp user id needs to  have  been  allocated  at
  148.      this point.
  149.  
  150.      The second once-only activity is to make sure that  PP  will
  151.      run when when the machine goes multi-user.  On Berkeley UNIX
  152.      systems,  add   something   along   these   lines   to   the
  153.      /etc/rc.local file:
  154.  
  155.           if [ -f /usr/lib/pp/pp.start ]; then
  156.               /usr/lib/pp/pp.start & (echo -n ' pp') > /dev/console
  157.           fi
  158.  
  159.      There are some examples of this start-up script in the  con-
  160.      fig directory.
  161.  
  162.   NOTE
  163.      If you wish to use smtp then it may be appropriate to  start
  164.      the  smtp server for /_e_t_c/_i_n_e_t_d by adding a suitable line to
  165.      /etc/inetd.conf. See Volume 1  for  more  details,  but  the
  166.      basic format is something like:
  167.  
  168.          smtp stream tcp nowait  pp  /usr/lib/pp/cmds/chans/smtpd
  169.             smtpd /usr/lib/pp/cmds/chans/smtpsrvr smtp
  170.  
  171.  
  172.      To allow processes to contact the qmgr you must add  a  line
  173.      to your isoentities file,
  174.  
  175.           pickle "pp qmgr" 1.17.6.2.1 #1001/Internet=pickle+18000
  176.  
  177.      You will need to replace "pickle" by your  local  host,  and
  178.      you  may need to change the isomacro "Internet" to something
  179.      else if you have a local ethernet or similar.
  180.  
  181.      Alternatively you may add a suitable entry to the  directory
  182.      if  this  is  being  used  as a nameserver. Some samples are
  183.      given below the examples directory.
  184.  
  185.      Then to install the following each-time activity is:
  186.  
  187.           % su
  188.           Password:
  189.           # ./make install
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sun Release 4.1     Last change: 25 Nov 1989                    3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. PP-GEN(8)             MAINTENANCE COMMANDS              PP-GEN(8)
  203.  
  204.  
  205.  
  206.      If you plan to run the MTAconsole program (and you  should!)
  207.      you will need to install the application defaults file. This
  208.      is in the MTAconsole directory and it should be installed as
  209.      MTAconsole  in  the app-defaults directory in your X hierar-
  210.      chy. For instance:
  211.  
  212.           # cd Src/MTAconsole
  213.           # cp MTAconsole.ad /usr/lib/X11/app-defaults/MTAconsole
  214.  
  215.      The same is true of the user  utility  xalert.  This  has  a
  216.      similar   set   of   application  defaults  that  should  be
  217.      installed.
  218.  
  219.      That's about it.  This will install everything.  To clean-up
  220.      the source tree as well, then use:
  221.  
  222.           % make clean
  223.  
  224.      at this point. (However, unless you are very tight for space
  225.      save this step until you are sure things are working.)
  226.  
  227.      If this is the first time you have used PP it is worth pick-
  228.      ing  one  of  the  example  configurations  in the examples/
  229.      directory. Choose a sample that is close  to  your  require-
  230.      ments as a starting point. The available samples are
  231.  
  232.           LOCALSMTP  Very simple local smtp only
  233.           JANET      A simple JANET configuration
  234.           INTERNET   A simple Internet site
  235.  
  236.      Change to one of these  directories,  and  read  the  README
  237.      there. This will tell you to do various things, depending on
  238.      what configuration you have chosen. Remember, this  is  only
  239.      an example and will not deal with all your needs.
  240.  
  241.      After all is set up, and at regular  intervals,  you  should
  242.      check  all  is  ok  by  running _c_k_c_o_n_f_i_g (found in the tools
  243.      directory) which will check things are installed correctly.
  244.  
  245.      Finally, if you are interested in discussing PP with  others
  246.      running  the  software,  drop  a  note  to the Janet mailbox
  247.      "pp-people-request@cs.ucl.ac.uk", and ask to be added to the
  248.      "pp-people@cs.ucl.ac.uk" list.
  249.  
  250. TAILORING
  251.      Tailoring is an essential part of running PP. This is  some-
  252.      what  complex  to  achieve  the  correct  setup  and  so  is
  253.      described in Volume 1 of the PP manual. It is important that
  254.      this is followed carefully.
  255.  
  256. GENERATING DOCUMENTATION
  257.      The directory doc/ contains the documentation set  for  this
  258.  
  259.  
  260.  
  261. Sun Release 4.1     Last change: 25 Nov 1989                    4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. PP-GEN(8)             MAINTENANCE COMMANDS              PP-GEN(8)
  269.  
  270.  
  271.  
  272.      release.   Consult the file doc/READ-ME for a description of
  273.      each document.  The directory  doc/ps/  contains  PostScript
  274.      versions  of  each  document.  These can be used to generate
  275.      standard documentation on PostScript printers, but users who
  276.      want  to  preview the documentation should generate the .dvi
  277.      files from the SLiTeX and LaTeX sources.
  278.  
  279.      If you received this distribution from the network, then the
  280.      directory  doc/ps/  does  not  contain any PostScript files.
  281.      There should be a separate compressed _t_a_r  file,  containing
  282.      only  PostScript  files,  available on the machine where you
  283.      retrieved this distribution.
  284.  
  285. REPORTING PROBLEMS
  286.      Comments concerning this release should be directed  to  the
  287.      authors.   Consult  the  preface  in the _U_s_e_r'_s _M_a_n_u_a_l for a
  288.      current postal address.  Alternately, if you have access  to
  289.      the  Janet  network,  comments  may  be  sent to the mailbox
  290.      "pp-support@cs.ucl.ac.uk".  Do not send bug reports  to  the
  291.      pp-people discussion group.
  292.  
  293. SEE ALSO
  294.      ckconfig(8), dbmbuild(8)
  295.      _T_h_e _P_P _M_a_n_u_a_l: _V_o_l_u_m_e _1 - _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _O_p_e_r_a_t_i_o_n
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327. Sun Release 4.1     Last change: 25 Nov 1989                    5
  328.  
  329.  
  330.  
  331.